package com.example.docmanagement.dto.response;

import com.fasterxml.jackson.annotation.JsonInclude;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.util.Map;

/**
 * 统一 API 响应格式
 * 
 * @param <T> 数据类型
 */
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@JsonInclude(JsonInclude.Include.NON_NULL) // 空字段不序列化
@Schema(description = "统一API响应格式")
public class ApiResponse<T> {

    /**
     * 是否成功
     */
    @Schema(description = "是否成功", example = "true")
    private Boolean success;

    /**
     * 响应数据
     */
    @Schema(description = "响应数据")
    private T data;

    /**
     * 响应消息
     */
    @Schema(description = "响应消息", example = "操作成功")
    private String message;

    /**
     * 元数据（如分页信息）
     */
    @Schema(description = "元数据")
    private Map<String, Object> meta;

    /**
     * 错误信息（仅在失败时返回）
     */
    @Schema(description = "错误信息")
    private ErrorInfo error;

    /**
     * 成功响应（带数据）
     */
    public static <T> ApiResponse<T> success(T data) {
        return ApiResponse.<T>builder()
                .success(true)
                .data(data)
                .message("操作成功")
                .build();
    }

    /**
     * 成功响应（带数据和消息）
     */
    public static <T> ApiResponse<T> success(T data, String message) {
        return ApiResponse.<T>builder()
                .success(true)
                .data(data)
                .message(message)
                .build();
    }

    /**
     * 成功响应（带数据、消息和元数据）
     */
    public static <T> ApiResponse<T> success(T data, String message, Map<String, Object> meta) {
        return ApiResponse.<T>builder()
                .success(true)
                .data(data)
                .message(message)
                .meta(meta)
                .build();
    }

    /**
     * 失败响应
     */
    public static <T> ApiResponse<T> error(String message) {
        return ApiResponse.<T>builder()
                .success(false)
                .message(message)
                .build();
    }

    /**
     * 失败响应（带错误码）
     */
    public static <T> ApiResponse<T> error(String code, String message) {
        return ApiResponse.<T>builder()
                .success(false)
                .message(message)
                .error(new ErrorInfo(code, message, null))
                .build();
    }

    /**
     * 失败响应（带错误详情）
     */
    public static <T> ApiResponse<T> error(String code, String message, Object details) {
        return ApiResponse.<T>builder()
                .success(false)
                .message(message)
                .error(new ErrorInfo(code, message, details))
                .build();
    }

    /**
     * 错误信息
     */
    @Data
    @NoArgsConstructor
    @AllArgsConstructor
    @JsonInclude(JsonInclude.Include.NON_NULL)
    @Schema(description = "错误信息")
    public static class ErrorInfo {
        /**
         * 错误码
         */
        @Schema(description = "错误码", example = "VALIDATION_ERROR")
        private String code;

        /**
         * 错误消息
         */
        @Schema(description = "错误消息", example = "参数验证失败")
        private String message;

        /**
         * 错误详情（如验证错误的字段列表）
         */
        @Schema(description = "错误详情")
        private Object details;
    }
}
